@egbe-ai/opencode 0.0.0-stage → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- package/update.js +361 -0
package/LICENSE
ADDED
package/README.md
CHANGED
|
@@ -1,3 +1,125 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Egbe for OpenCode
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Egbe is an AI co-founder's business stack. This plugin connects
|
|
4
|
+
[OpenCode](https://opencode.ai) to the business you run with Egbe, so OpenCode
|
|
5
|
+
can build, launch and grow it for you: hosting and databases, email, analytics,
|
|
6
|
+
payments, advertising, market research, web search and scraping, and an LLM,
|
|
7
|
+
all billed to your Egbe wallet.
|
|
8
|
+
|
|
9
|
+
It works with OpenCode 1.x (1.18.29 or later) and OpenCode 2.x.
|
|
10
|
+
|
|
11
|
+
## Get started
|
|
12
|
+
|
|
13
|
+
1. Add the plugin to your OpenCode configuration (`opencode.json` in your
|
|
14
|
+
project, or `~/.config/opencode/opencode.json` for every project):
|
|
15
|
+
|
|
16
|
+
```jsonc
|
|
17
|
+
// OpenCode 2.x
|
|
18
|
+
{ "plugins": ["@egbe-ai/opencode"] }
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
```jsonc
|
|
22
|
+
// OpenCode 1.x
|
|
23
|
+
{ "plugin": ["@egbe-ai/opencode"] }
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
In OpenCode 2.x, `opencode plugin add @egbe-ai/opencode` does the same.
|
|
27
|
+
OpenCode installs the package from npm when it starts.
|
|
28
|
+
2. Sign in to Egbe once: run `opencode mcp auth egbe` in a terminal (in OpenCode
|
|
29
|
+
2.x, `/mcps` in OpenCode works too), sign in in the browser that opens and
|
|
30
|
+
select **Connect**. Then restart OpenCode.
|
|
31
|
+
3. Ask OpenCode to set up Egbe.
|
|
32
|
+
|
|
33
|
+
You need an Egbe account. The sign-in covers all your Egbe businesses; in each
|
|
34
|
+
conversation OpenCode works on the business you name. Manage or disconnect
|
|
35
|
+
connected assistants at <https://dashboard.egbe.ai/settings/connections>.
|
|
36
|
+
|
|
37
|
+
## What the plugin contains
|
|
38
|
+
|
|
39
|
+
- **The Egbe connector** (`https://os.hz.egbe.dev/mcp`), a remote MCP server
|
|
40
|
+
named `egbe` that OpenCode calls to read your project and perform the work you
|
|
41
|
+
ask for. It signs in through your Egbe account with OpenCode's own MCP sign-in;
|
|
42
|
+
the plugin holds no key. If your configuration already defines an `egbe` MCP
|
|
43
|
+
server, for example one connected with a business key, the plugin keeps yours.
|
|
44
|
+
- **Skills** that teach OpenCode how to use each Egbe capability, in the
|
|
45
|
+
package's `skills/` folder. A project's own installed copy of a skill takes
|
|
46
|
+
precedence.
|
|
47
|
+
- **Session logging**, described below.
|
|
48
|
+
|
|
49
|
+
The plugin runs no local server. A skill's scripts run only when OpenCode runs
|
|
50
|
+
one for a step in a project folder set up for Egbe.
|
|
51
|
+
|
|
52
|
+
**In a project folder**, OpenCode also sets the project up for Egbe, which plain
|
|
53
|
+
chats skip. It saves your project's Egbe key in the folder's Git-ignored
|
|
54
|
+
`.env.local` and copies Egbe's project guidance (`EGBE.md`) and editable working
|
|
55
|
+
methods (`egbe-docs/playbooks/`) from the plugin into the project. Egbe's skills
|
|
56
|
+
stay in the plugin and update with it.
|
|
57
|
+
|
|
58
|
+
## What it sends and where
|
|
59
|
+
|
|
60
|
+
OpenCode sends the requests it makes on your behalf, such as a page to publish,
|
|
61
|
+
an email to send or a search to run, to Egbe at `https://os.hz.egbe.dev` over
|
|
62
|
+
the connector. Egbe acts only for the business you approved, within your wallet
|
|
63
|
+
limits, and records these requests so you can review activity and spending in
|
|
64
|
+
Egbe's dashboard. The authorized Egbe team can also read each connector call,
|
|
65
|
+
with its inputs and results, to support you and improve Egbe. Some capabilities
|
|
66
|
+
pass requests on to the provider that performs them, for example a payment,
|
|
67
|
+
email or advertising provider. Egbe's [privacy policy](https://egbe.ai/privacy/)
|
|
68
|
+
describes how this data is handled.
|
|
69
|
+
|
|
70
|
+
**Session logging is on by default.** By installing the plugin you agree that
|
|
71
|
+
Egbe records your OpenCode sessions in project folders set up for Egbe;
|
|
72
|
+
OpenCode also tells you when it sets up a folder. When a run of a session ends,
|
|
73
|
+
the plugin sends that run's turn (your message, model calls with usage, tool
|
|
74
|
+
calls with their inputs and results, and the reply) to Egbe at
|
|
75
|
+
`https://observe.hz.egbe.dev/telemetry`, authenticated with the project's Egbe
|
|
76
|
+
key. Images and attachments are not sent, and secrets are redacted on a
|
|
77
|
+
best-effort basis. The authorized Egbe team can read these records. The plugin
|
|
78
|
+
sends nothing from a folder that is not set up for Egbe (no private
|
|
79
|
+
`.env.local` with Egbe's settings) and never sends anywhere but Egbe. It records
|
|
80
|
+
each run's result, never a secret, under `lastSessionLog` in
|
|
81
|
+
`~/.local/state/egbe/opencode-plugin.json`.
|
|
82
|
+
|
|
83
|
+
To stop, ask OpenCode to turn session logging off, or set
|
|
84
|
+
`EGBE_SESSION_LOGGING=off` in the project's `.env.local`. To turn it off for
|
|
85
|
+
every project, set the plugin's `sessionLogging` option to `false`:
|
|
86
|
+
|
|
87
|
+
```jsonc
|
|
88
|
+
// OpenCode 2.x; in 1.x: { "plugin": [["@egbe-ai/opencode", { "sessionLogging": false }]] }
|
|
89
|
+
{ "plugins": [{ "package": "@egbe-ai/opencode", "options": { "sessionLogging": false } }] }
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Updates
|
|
93
|
+
|
|
94
|
+
The plugin updates itself from npm when OpenCode runs for a while: a minute
|
|
95
|
+
after it loads and every six hours, it checks npm for a newer `@egbe-ai/opencode`,
|
|
96
|
+
verifies the download against npm's SHA-512 integrity and checks that the new
|
|
97
|
+
version loads, then installs it. OpenCode 1.x loads it at its next start;
|
|
98
|
+
OpenCode 2.x installs and reloads it with `opencode plugin update`. A version
|
|
99
|
+
that would change what the plugin can do (its MCP servers, tools, commands or
|
|
100
|
+
hooks) is not installed automatically: update it yourself with
|
|
101
|
+
`opencode plugin update @egbe-ai/opencode` in OpenCode 2, or in 1.x by deleting
|
|
102
|
+
`~/.cache/opencode/packages/@egbe-ai/opencode@latest` and restarting OpenCode.
|
|
103
|
+
A pinned version (`@egbe-ai/opencode@0.1.2`) and a plugin loaded from a folder are
|
|
104
|
+
not updated; update a cloned folder with `git pull`. Each check is recorded
|
|
105
|
+
under `update` in `~/.local/state/egbe/opencode-plugin.json`. To turn updates
|
|
106
|
+
off, set the `autoUpdate` option to `false`, as for `sessionLogging` above.
|
|
107
|
+
|
|
108
|
+
## What it downloads
|
|
109
|
+
|
|
110
|
+
The plugin itself downloads nothing, and setting up a project folder copies
|
|
111
|
+
files that come with the plugin.
|
|
112
|
+
|
|
113
|
+
Files that exceed the plugin directory's size limits are listed in their
|
|
114
|
+
skill; OpenCode downloads one from Egbe only when a step needs it and checks its
|
|
115
|
+
SHA-256:
|
|
116
|
+
|
|
117
|
+
- `egbe-os-design-landing-page/assets/lockfiles/accounts/package-lock.json` from https://os.hz.egbe.dev/skills/egbe-os-design-landing-page/resources/assets/lockfiles/accounts/package-lock.json
|
|
118
|
+
- `egbe-os-design-landing-page/assets/lockfiles/auth-db/package-lock.json` from https://os.hz.egbe.dev/skills/egbe-os-design-landing-page/resources/assets/lockfiles/auth-db/package-lock.json
|
|
119
|
+
- `egbe-os-design-landing-page/assets/scaffold/package-lock.json` from https://os.hz.egbe.dev/skills/egbe-os-design-landing-page/resources/assets/scaffold/package-lock.json
|
|
120
|
+
- `egbe-os-design-landing-page/assets/scaffold/.gitignore` from https://os.hz.egbe.dev/skills/egbe-os-design-landing-page/resources/assets/scaffold/.gitignore
|
|
121
|
+
|
|
122
|
+
## Support
|
|
123
|
+
|
|
124
|
+
Questions and problems: ask OpenCode to open an Egbe support ticket, or email
|
|
125
|
+
<support@egbe.ai>.
|
package/index.js
ADDED
package/package.json
CHANGED
|
@@ -1,6 +1,57 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@egbe-ai/opencode",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
6
|
-
|
|
3
|
+
"version": "0.1.8",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Egbe's plugin for OpenCode: the Egbe connector, Egbe's skills and session logging.",
|
|
6
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
7
|
+
"homepage": "https://egbe.ai",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/egbe-ai/egbe-plugins.git",
|
|
11
|
+
"directory": "plugins/egbe-opencode"
|
|
12
|
+
},
|
|
13
|
+
"keywords": [
|
|
14
|
+
"opencode",
|
|
15
|
+
"opencode-plugin",
|
|
16
|
+
"egbe",
|
|
17
|
+
"mcp"
|
|
18
|
+
],
|
|
19
|
+
"main": "./index.js",
|
|
20
|
+
"exports": {
|
|
21
|
+
".": "./index.js",
|
|
22
|
+
"./server": "./index.js",
|
|
23
|
+
"./package.json": "./package.json"
|
|
24
|
+
},
|
|
25
|
+
"files": [
|
|
26
|
+
"index.js",
|
|
27
|
+
"plugin.js",
|
|
28
|
+
"session-log.js",
|
|
29
|
+
"state.js",
|
|
30
|
+
"update.js",
|
|
31
|
+
"skills/",
|
|
32
|
+
"README.md",
|
|
33
|
+
"LICENSE"
|
|
34
|
+
],
|
|
35
|
+
"engines": {
|
|
36
|
+
"opencode": ">=1.18.29"
|
|
37
|
+
},
|
|
38
|
+
"egbe": {
|
|
39
|
+
"capabilities": {
|
|
40
|
+
"mcpServers": [
|
|
41
|
+
"egbe"
|
|
42
|
+
],
|
|
43
|
+
"tools": [],
|
|
44
|
+
"commands": [],
|
|
45
|
+
"v1Hooks": [
|
|
46
|
+
"config",
|
|
47
|
+
"event",
|
|
48
|
+
"dispose"
|
|
49
|
+
],
|
|
50
|
+
"v2": [
|
|
51
|
+
"mcp.transform",
|
|
52
|
+
"skill.transform",
|
|
53
|
+
"event.subscribe"
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
package/plugin.js
ADDED
|
@@ -0,0 +1,230 @@
|
|
|
1
|
+
// Egbe's native OpenCode plugin, published from egbe-ai/claw-swarm plugins/opencode
|
|
2
|
+
// as the npm package @egbe-ai/opencode (and under plugins/egbe-opencode/ of
|
|
3
|
+
// egbe-ai/egbe-plugins). index.js exports only its default, which plugin loaders read.
|
|
4
|
+
//
|
|
5
|
+
// One default export serves both plugin APIs, as OpenCode's V1 migration guide
|
|
6
|
+
// describes: OpenCode 1.x (1.18.29 and later) calls `server()`, OpenCode 2.x
|
|
7
|
+
// calls `setup()`. Either way the plugin
|
|
8
|
+
// - adds the Egbe MCP server (`egbe`, remote, signed in with OpenCode's own MCP
|
|
9
|
+
// OAuth and Dashboard's dynamic client registration) unless the founder's
|
|
10
|
+
// configuration already defines one;
|
|
11
|
+
// - adds Egbe's skills bundled in this package's `skills/` folder;
|
|
12
|
+
// - logs each run of a session in a project folder set up for Egbe to Egbe's
|
|
13
|
+
// telemetry gateway (session-log.js);
|
|
14
|
+
// - updates itself from npm (update.js).
|
|
15
|
+
import { readFileSync, readdirSync } from "node:fs";
|
|
16
|
+
import path from "node:path";
|
|
17
|
+
import { fileURLToPath } from "node:url";
|
|
18
|
+
import {
|
|
19
|
+
GATEWAY, OS_URL, lastTurnId, loggingSettings, projectFolder, sendTurn, stepsFromV1, stepsFromV2, turnTraces,
|
|
20
|
+
} from "./session-log.js";
|
|
21
|
+
import { statePath, writeState } from "./state.js";
|
|
22
|
+
import { checkForUpdate, scheduleUpdates, updaterSettings, v1Install, v2Install } from "./update.js";
|
|
23
|
+
|
|
24
|
+
export const PLUGIN_ID = "egbe";
|
|
25
|
+
export const MCP_NAME = "egbe";
|
|
26
|
+
const MODULE_ROOT = path.dirname(fileURLToPath(import.meta.url));
|
|
27
|
+
const PACKAGE_JSON = JSON.parse(readFileSync(path.join(MODULE_ROOT, "package.json"), "utf8"));
|
|
28
|
+
export const VERSION = PACKAGE_JSON.version;
|
|
29
|
+
// What an update may not change without the founder: see update.js.
|
|
30
|
+
export const CAPABILITIES = PACKAGE_JSON.egbe?.capabilities;
|
|
31
|
+
export const SKILLS_DIR = path.join(MODULE_ROOT, "skills");
|
|
32
|
+
// OpenCode 2.x events that end a run of a session.
|
|
33
|
+
export const RUN_ENDED = ["session.execution.succeeded", "session.execution.failed", "session.execution.interrupted"];
|
|
34
|
+
|
|
35
|
+
export { statePath };
|
|
36
|
+
|
|
37
|
+
function recordResult(entry) {
|
|
38
|
+
writeState({ lastSessionLog: entry });
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** The telemetry gateway: Egbe's, or a loopback test gateway named in the plugin options. */
|
|
42
|
+
export function gatewayUrl(options) {
|
|
43
|
+
const raw = options?.telemetryUrl;
|
|
44
|
+
if (raw === undefined) return GATEWAY;
|
|
45
|
+
const url = new URL(String(raw));
|
|
46
|
+
const loopback = url.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname);
|
|
47
|
+
if (url.href.replace(/\/$/, "") !== GATEWAY && !loopback) throw new Error("telemetryUrl must be Egbe's gateway or a loopback test gateway");
|
|
48
|
+
return url.href.replace(/\/$/, "");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function frontmatter(content) {
|
|
52
|
+
const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(content);
|
|
53
|
+
if (!match) return undefined;
|
|
54
|
+
const fields = {};
|
|
55
|
+
for (const line of match[1].split(/\r?\n/)) {
|
|
56
|
+
const field = /^(name|description):\s*(.*)$/.exec(line);
|
|
57
|
+
if (field) fields[field[1]] = field[2].trim().replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1");
|
|
58
|
+
}
|
|
59
|
+
return { fields, body: content.slice(match[0].length) };
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** The bundled skills as OpenCode 2.x `Skill.Info` entries (one level under `skills/`). */
|
|
63
|
+
export function bundledSkills(dir = SKILLS_DIR) {
|
|
64
|
+
let names;
|
|
65
|
+
try {
|
|
66
|
+
names = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => e.name);
|
|
67
|
+
} catch {
|
|
68
|
+
return [];
|
|
69
|
+
}
|
|
70
|
+
const skills = [];
|
|
71
|
+
for (const name of names.sort()) {
|
|
72
|
+
const file = path.join(dir, name, "SKILL.md");
|
|
73
|
+
let parsed;
|
|
74
|
+
try {
|
|
75
|
+
parsed = frontmatter(readFileSync(file, "utf8"));
|
|
76
|
+
} catch {
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
if (!parsed) continue;
|
|
80
|
+
skills.push({
|
|
81
|
+
id: name, name: parsed.fields.name || name,
|
|
82
|
+
...(parsed.fields.description ? { description: parsed.fields.description } : {}),
|
|
83
|
+
path: file, content: parsed.body,
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
return skills;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** Adds the Egbe MCP server and the bundled skills to an OpenCode 1.x configuration. */
|
|
90
|
+
export function configureV1(config, skillsDir = SKILLS_DIR) {
|
|
91
|
+
config.mcp ??= {};
|
|
92
|
+
// A server the founder configured, such as one with a business key, stays as it is.
|
|
93
|
+
if (!config.mcp[MCP_NAME]) config.mcp[MCP_NAME] = { type: "remote", url: `${OS_URL}/mcp` };
|
|
94
|
+
if (bundledSkills(skillsDir).length) {
|
|
95
|
+
config.skills ??= {};
|
|
96
|
+
config.skills.paths ??= [];
|
|
97
|
+
if (!config.skills.paths.includes(skillsDir)) config.skills.paths.push(skillsDir);
|
|
98
|
+
}
|
|
99
|
+
return config;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
// Code Mode off: Egbe's skills name the connector's tools, so they stay on the native tool list.
|
|
103
|
+
export const MCP_V2 = { type: "remote", url: `${OS_URL}/mcp`, codemode: false };
|
|
104
|
+
|
|
105
|
+
/** Logs the last turn of a session once its run ends; never throws. */
|
|
106
|
+
export function sessionLogger({ api, options, root, readSteps, fetchImpl, record = recordResult }) {
|
|
107
|
+
const sent = new Map();
|
|
108
|
+
const running = new Map();
|
|
109
|
+
const publicKeys = new Map();
|
|
110
|
+
async function log(sessionID, directory) {
|
|
111
|
+
const folder = projectFolder(directory, root);
|
|
112
|
+
let result;
|
|
113
|
+
try {
|
|
114
|
+
const settings = loggingSettings(folder, options);
|
|
115
|
+
if (settings.off) {
|
|
116
|
+
result = `off: ${settings.off}`;
|
|
117
|
+
} else {
|
|
118
|
+
const steps = await readSteps(sessionID);
|
|
119
|
+
const turn = lastTurnId(steps);
|
|
120
|
+
if (turn !== undefined && sent.get(sessionID) === turn) return;
|
|
121
|
+
const body = turnTraces({ steps, sessionID, workspace: folder, version: VERSION, api });
|
|
122
|
+
if (!body) {
|
|
123
|
+
result = "skipped: no founder message in the run";
|
|
124
|
+
} else {
|
|
125
|
+
result = await sendTurn({ settings, body, publicKeyCache: publicKeys, gateway: gatewayUrl(options),
|
|
126
|
+
...(fetchImpl ? { fetchImpl } : {}) });
|
|
127
|
+
if (result === "sent") sent.set(sessionID, turn);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
} catch (error) {
|
|
131
|
+
result = `failed: ${error?.message ?? error}`;
|
|
132
|
+
}
|
|
133
|
+
record({ at: new Date().toISOString(), result, session: sessionID, workspace: folder ? path.basename(folder) : "" });
|
|
134
|
+
return result;
|
|
135
|
+
}
|
|
136
|
+
return {
|
|
137
|
+
/** Both `session.status` (idle) and the older `session.idle` may announce one end: runs coalesce. */
|
|
138
|
+
idle(sessionID, directory) {
|
|
139
|
+
if (typeof sessionID !== "string" || !sessionID) return Promise.resolve();
|
|
140
|
+
const previous = running.get(sessionID) ?? Promise.resolve();
|
|
141
|
+
const next = previous.then(() => log(sessionID, directory));
|
|
142
|
+
running.set(sessionID, next);
|
|
143
|
+
return next.finally(() => {
|
|
144
|
+
if (running.get(sessionID) === next) running.delete(sessionID);
|
|
145
|
+
});
|
|
146
|
+
},
|
|
147
|
+
/** Waits, for at most `limit` ms, for runs being logged, so a short-lived `opencode run` still sends its turn. */
|
|
148
|
+
async flush(limit = 15_000) {
|
|
149
|
+
let timer;
|
|
150
|
+
const timeout = new Promise((resolve) => { timer = setTimeout(resolve, limit); });
|
|
151
|
+
await Promise.race([Promise.allSettled([...running.values()]), timeout]);
|
|
152
|
+
clearTimeout(timer);
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** OpenCode 1.x: returns the hooks object. */
|
|
158
|
+
export async function server(input, options) {
|
|
159
|
+
const settings = updaterSettings(options);
|
|
160
|
+
const stopUpdates = scheduleUpdates({
|
|
161
|
+
settings,
|
|
162
|
+
check: () => checkForUpdate({ version: VERSION, capabilities: CAPABILITIES, install: v1Install(MODULE_ROOT), settings,
|
|
163
|
+
cwd: input?.directory }),
|
|
164
|
+
});
|
|
165
|
+
const logger = sessionLogger({
|
|
166
|
+
api: "v1", options, root: input?.worktree,
|
|
167
|
+
readSteps: async (id) => {
|
|
168
|
+
const res = await input.client.session.messages({ path: { id }, query: { directory: input.directory } });
|
|
169
|
+
return stepsFromV1(res?.data ?? res);
|
|
170
|
+
},
|
|
171
|
+
});
|
|
172
|
+
return {
|
|
173
|
+
async config(config) {
|
|
174
|
+
configureV1(config);
|
|
175
|
+
},
|
|
176
|
+
async event({ event }) {
|
|
177
|
+
const idle = event?.type === "session.idle" || (event?.type === "session.status" && event.properties?.status?.type === "idle");
|
|
178
|
+
if (idle) await logger.idle(event.properties?.sessionID, input?.directory);
|
|
179
|
+
},
|
|
180
|
+
async dispose() {
|
|
181
|
+
stopUpdates();
|
|
182
|
+
await logger.flush();
|
|
183
|
+
},
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** OpenCode 2.x: registers transforms and the session-logging subscription. */
|
|
188
|
+
export async function setup(ctx) {
|
|
189
|
+
await ctx.mcp.transform((editor) => {
|
|
190
|
+
if (!editor.get(MCP_NAME)) editor.set(MCP_NAME, MCP_V2);
|
|
191
|
+
});
|
|
192
|
+
const skills = bundledSkills();
|
|
193
|
+
if (skills.length) {
|
|
194
|
+
await ctx.skill.transform((editor) => {
|
|
195
|
+
// A project's own installed copy of a skill wins over the plugin's.
|
|
196
|
+
for (const skill of skills) if (!editor.get(skill.id)) editor.add(skill);
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
const here = ctx.location?.directory;
|
|
200
|
+
const logger = sessionLogger({
|
|
201
|
+
api: "v2", options: ctx.options, root: ctx.location?.project?.directory,
|
|
202
|
+
readSteps: async (sessionID) => stepsFromV2(await ctx.session.context({ sessionID })),
|
|
203
|
+
});
|
|
204
|
+
const settings = updaterSettings(ctx.options);
|
|
205
|
+
const stopUpdates = scheduleUpdates({
|
|
206
|
+
settings,
|
|
207
|
+
check: () => checkForUpdate({ version: VERSION, capabilities: CAPABILITIES, settings, cwd: here,
|
|
208
|
+
install: async () => v2Install(await ctx.plugin.list({ location: here ? { directory: here } : undefined })) }),
|
|
209
|
+
});
|
|
210
|
+
const controller = new AbortController();
|
|
211
|
+
void (async () => {
|
|
212
|
+
try {
|
|
213
|
+
for await (const event of ctx.event.subscribe({ types: RUN_ENDED, signal: controller.signal })) {
|
|
214
|
+
// Each plugin instance logs only its own location's sessions.
|
|
215
|
+
const where = event?.location?.directory;
|
|
216
|
+
if (where && here && where !== here) continue;
|
|
217
|
+
await logger.idle(event?.data?.sessionID, where ?? here);
|
|
218
|
+
}
|
|
219
|
+
} catch {
|
|
220
|
+
// The stream ends when the plugin unloads.
|
|
221
|
+
}
|
|
222
|
+
})();
|
|
223
|
+
return async () => {
|
|
224
|
+
stopUpdates();
|
|
225
|
+
controller.abort();
|
|
226
|
+
await logger.flush();
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
export default { id: PLUGIN_ID, setup, server };
|